home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #2 / Amiga Plus CD - 1995 - No. 2.iso / internet / faq / englisch / comp.text.interleaf < prev    next >
Encoding:
Text File  |  1995-04-11  |  60.5 KB  |  1,487 lines

  1. Archive-name: interleaf-faq
  2. Version:  $Id: interleaf.faq,v 2.4 1995/02/18 23:18:14 ram Exp $
  3. Posting-Frequency: monthly, on the 13th
  4. Posting-Agent: post_faq.pl, by Jonathan Kamens
  5.  
  6.  
  7.  
  8. ***  INTERLEAF FAQ  --  Frequently Asked Questions for comp.text.interleaf  ***
  9.  
  10.     This "FAQ" document is arranged into 7 sections:
  11.     0.    What's new in the FAQ
  12.     1.    Introduction - General info
  13.     2.    Administration
  14.     3.    Importing/Exporting, 3rd party tools, customizing
  15.     4.    Miscellaneous user questions
  16.     and then broken down further, in outline form rather than "FAQ list" form.
  17.     All section and sub-section numbers are in the form "a.b.c.d", and begin
  18.     in column 1 for easy searching in your favorite editor.
  19.     5.    Platform specific questions
  20.     6.    Interleaf6
  21.     7.    Cyberleaf
  22.     Appendix. Other Information: newsletters; ftp, gopher and WWW sites.
  23.  
  24.  
  25. 0.     What's new in the FAQ
  26.  
  27.     rev 2.3
  28.     -added section 7 on Cyberleaf
  29.     -minor spelling errors corrected
  30.  
  31.     21dec94 rev 2.2
  32.     - add pointers to Julie Barker FAQ list, update archive
  33.     pointers. 
  34.  
  35.     04dec94
  36.  
  37.     - Change revision level to 2.0 to reflect that Interleaf 6 is
  38.     now included (as it was on recent previous revision). No
  39.     substantive changes.
  40.  
  41.  
  42.     17nov94
  43.  
  44.     - Section 0 ("What's new")
  45.     -  Section 6 ("Interleaf6"),
  46.  
  47.     - Appendix  ("Other information")  added by ram@cs.umb.edu; minor
  48.     revisions by ram@cs.umb.edu
  49.  
  50.     - Update references to I6 as though it were a future, which it
  51.     no longer is.
  52.  
  53.  
  54. 1.    Introduction
  55.  
  56.  
  57. 1.1.     What is Interleaf?
  58.  
  59.     Interleaf, Inc. provides software and services to allow organizations
  60.     to build, integrate and manage document systems.  Interleaf software
  61.     covers the full range of document processes: accessing information,
  62.     developing text and graphic documents,  putting them through their
  63.     review and revision processes,  distributing them electronically or on
  64.     paper, and managing the entire process.
  65.  
  66.     "Interleaf 5" is a document authoring and composition package.  It
  67.     provides an integrated set of tools for creating compound documents:
  68.     word processing, graphics, data-driven business charts, tables,
  69.     equations, image editing, automated page layout, book building-
  70.     including automatic index and TOC, conditional document assembly.  It
  71.     includes several features engineered to support the production of large
  72.     and complex document sets, including:  centralized control over parts
  73.     or all of a document (format and/or content), global search and
  74.     replace/change on individual graphics objects regardless of specific
  75.     orientation or position, revision management.
  76.  
  77.     Also available is the optional Developer's Toolkit (DTK) for
  78.     customizing or extending the capabilities of the above authoring tool.
  79.     Developer's Toolkit is used to write programs in Interleaf Lisp.
  80.     Interleaf Lisp is similar to CommonLISP, but it also contains an
  81.     extensive set of classes, methods, and functions for examining and
  82.     changing almost all Interleaf objects, including documents and their
  83.     contents.  DTK includes an editor, debugger, compiler, listener,
  84.     interpreter, and on-line documentation.  Lisp code developed with DTK,
  85.     or even written with an ordinary editor, can be executed by the stock
  86.     system, so that customization or the provision of special functionality
  87.     is not limited to installations with DTK.  In fact, much of the
  88.     distributed system is written in Lisp.
  89.  
  90.     Another option for Interleaf 5 is "Interleaf 5 <SGML>" which provides
  91.     complete support for creating structured documents in SGML.
  92.  
  93.     Other products available from Interleaf include the following:
  94.  
  95.     "RDM" (Relational Document Manager) organizes, tracks and manages
  96.     documents and data, and automates every stage of the document
  97.     lifecycle.
  98.  
  99.     "Worldview" distributes information from virtually any source in
  100.     document form for online viewing on virtually any computer.  It
  101.     combines electronic viewing with hypertext navigation and full-text
  102.     retrieval.
  103.  
  104.  
  105. 1.2.    What platforms does Interleaf run on, and what are the latest versions?
  106.  
  107.     Interleaf 6:
  108.  
  109.     Interleaf 6.0 has been released on certain Unix platforms with
  110.     the Motif User Interface. The product is available for Sun,
  111.     HP, IBM, and DEC (OSF 1 1.3.x) workstations. Requirements for
  112.     memory range from 16mB to 32mB and disk requirements from 36
  113.     to 68mB, in addition to minimum swap space of from 32-64 mB
  114.     per session, with 64-128mB per host.
  115.  
  116.     Interleaf 6.1 is scheduled for release late in 1994 on these
  117.     platforms, as well as under MSWindows.
  118.  
  119.  
  120.     Interleaf 5:
  121.  
  122.     Interleaf 5.3 remains available on the following workstation
  123.  
  124.     platforms:  DG Aviion, DEC VAX/VMS, DEC Ultrix, HP 700, HP
  125.     300/400, HP/Apollo (Domain), IBM RS/6000, 
  126.     Motorola Delta 8000, Sun-3, Sun-4, Silicon Graphics Iris.
  127.  
  128.     The "standard" version of Interleaf 5 provides a UI consistent across
  129.     all the platforms it runs on.
  130.  
  131.     DOS:  (386/486)
  132.     Interleaf 5.2.02 for DOS began shipping in June 1992.  This is the
  133.     currently shipping North American release.  Interleaf 5.3.1.1 began
  134.     shipping in March of 1993.  The 5.3 release includes international
  135.     localizations for French, German and Italian, Full Revision Tracking,
  136.     support for DEC Pathworks, improved/additional video device driver
  137.     support, and better support for running from within a Microsoft Windows
  138.     3.1 environment (as a DOS application).  Since Interleaf has not
  139.     completed work on the remaining localizations for Dutch, Spanish and
  140.     Swedish interfaces, this release is seeing limited distribution in
  141.     North America.  The additional languages and other new features will be
  142.     included in the upcoming release, Interleaf 5.4 for DOS.  Customers can
  143.     upgrade from Interleaf IBM Publisher 3.x. (aka version 1.x) to version
  144.     5.2.02 or wait for version 5.4.  Interleaf 5 for DOS is interoperable
  145.     with the Unix and VMS based versions.  It includes all the
  146.     functionality of the workstation-based product (tables, equations,
  147.     charting, graphics, etc.) plus some additional features that allow the
  148.     user to run in Microsoft Windows 3.1 environments without extra memory
  149.     managers or special set-ups.  Features planned for v5.4 include a new
  150.     simplified GUI install, 32-bit color image support and a new font
  151.     hierarchy to greatly reduce disk footprint.  General shipment of
  152.     Interleaf for DOS, version 5.4, including 5.2 to 5.4 upgrades to
  153.     contract customers, will take place in summer 1993.  Interleaf is
  154.     working on a version of Interleaf 5 for Microsoft Windows.
  155.  
  156.     MAC:
  157.     The current version is Interleaf Publisher for the Mac, version 3.6.
  158.     This product does not conform to the Mac UI, and is no longer available
  159.     from Interleaf.
  160.  
  161.     Interleaf has announced that no further Macintosh releases are
  162.     planned, though using a Macintosh as an X-server, with the
  163.     software running on a remote Unix system, is perfectly feasible.
  164.  
  165.  
  166. 1.3.    How much does Interleaf cost?
  167.  
  168.     Well, I don't know if Interleaf wants all their retail prices quoted
  169.     here, so let's just make some qualitative statements.  There are
  170.     several different "options" for Interleaf 5, including DTK, Revision
  171.     Tracking, and Book Catalogs.  The "base model" Interleaf license is
  172.     *very* competitive with FrameMaker, or other similar systems.  Adding
  173.     the above options can be quite expensive.  Many sites use a network
  174.     pool of many inexpensive "basic" licenses plus a few expensive "full
  175.     blown" licenses.
  176.  
  177.     It has been noted that Universities receive a tremendous educational
  178.     discount, and that commerical and educational license costs for
  179.     Interleaf and its competitors differ greatly depending on which country
  180.     you live in and which platform you are buying.  In the US, full-blown
  181.     Interleaf 6 is available to accredited colleges and universities for
  182.     $200 plus handling.  Terms for institutions of higher
  183.     education in other countries (and for businesses and individuals as
  184.     well) vary by country.
  185.  
  186.  
  187. 1.4    How does Interleaf compare to {FrameMaker,IslandWrite,WordPerfect,etc.}?
  188.  
  189.     This is a religious and/or political issue for many, and it is very
  190.     hard to provide an objective answer.  Therefore, I will just summarize
  191.     a few majority opinions from the frequent discussions in the newsgroup.
  192.  
  193.     Frame is generally considered to be a "mid-range" application; it is
  194.     easy to learn, but experienced users find complex tasks difficult or
  195.     impossible.  Many users hate the "toolbox", "Mac/PC-like" interface.
  196.  
  197.     Interleaf is thought of as a "high-end" system; it is difficult to get
  198.     started, but expandable and powerful when advanced tasks must be done.
  199.     While many new users abhor the UI, a seemingly equal number of experts
  200.     praise it.
  201.  
  202.     Interleaf's document creation metaphor is object oriented and
  203.     structured in approach, in contrast to the page-layout orientation of
  204.     many "Desktop Publishing" products like Frame, Quark, PageMaker, etc.
  205.     This is often a widely misunderstood difference when comparing
  206.     Interleaf to other "similar" products.
  207.  
  208.     IslandWrite, WordPerfect, MS-Word, et al. are considered low-end
  209.     applications.
  210.  
  211.     Interleaf has moved to the standard GUIs.  I6 for Motif
  212.     is the standard Unix release, and I6 for WIndows is scheduled
  213.     for late 1994 release.
  214.  
  215.  
  216. 1.5    How can I find out more information about Interleaf?
  217.  
  218.     Interleaf, Inc.
  219.     Prospect Place
  220.     9 Hillside Avenue
  221.     Waltham, MA  02154-9524
  222.     USA
  223.     1-617-290-0710
  224.  
  225.     US and Canada toll-free service numbers:
  226.      Customer Support Center               1-800-688-5151 support@ileaf.com
  227.      Customer Support Center--passwords    1-800-688-5151 password@ileaf.com
  228.      Training Registration                 1-800-685-LEAF
  229.      Interleaf Direct (product orders,     1-800-955-LEAF
  230.        identify nearest office)
  231.      User Groups, ICON, product literature 1-800-456-LEAF
  232.  
  233.     There are over 50 Interleaf USER GROUPS worldwide.  For information on
  234.     the nearest one, or for assistance on starting one, contact Interleaf
  235.     at 1-800-456-5323 (outside North America, call 1-617-290-0710, x4386).
  236.  
  237.     To receive Interleaf's quarterly NEWSLETTER and product announcements,
  238.     just send a request to "add me to your mailing list" to the home office
  239.     in your country.  Include your name, title, company, mailing address
  240.     and telephone number.  Also let them know which Interleaf products
  241.     you're using, and on which computer platforms.  Send it to the
  242.     attention of "Marketing."
  243.  
  244.     The "Leafline" BULLETIN BOARD is available to all Interleaf users.  It
  245.     provides a basic interface through which information, files and clipart
  246.     can be shared by Interleaf and between users.  The modem dial-in number
  247.     is 1-617-290-4996.  Modem settings are "standard": no parity, 8 bit, 1
  248.     stop bit.  Online prompts will ask you to register your name and
  249.     address.  You should have access within 24 business hours.  If you need
  250.     assistance, contact 1-800-666-5323, x3326 (outside North America, call
  251.     1-617-290-0710 x3326).
  252.  
  253.     Bundled with service contracts in North America is 24-hour dial-in
  254.     access to Customer Support's comprehensive "Releaf24" knowledgebase.
  255.     Contract customers can request "Releaf24 Registration Guidelines" by
  256.     calling 1-800-688-5151 or by sending email to support@ileaf.com.  Some
  257.     subsidiaries outside the US plan to offer this soon.
  258.  
  259.     ICON (Interleaf Users CONference) is an annual international event.
  260.     ICON '93 was held in Orlando, FL at the Hilton at Walt Disney World
  261.     Village February 28 - March 3.  ICON offers users the opportunity to
  262.     interact in-person with Interleaf people as well as other users.
  263.     Sessions are presented by Interleaf staff and users.  A developer's
  264.     track is also offered for experienced programmers developing Lisp
  265.     applications.  ICON '93 registration cost U.S. $650 which included all
  266.     sessions, Showcase, materials, dinner dance and most meals.  Over 800
  267.     users attended ICON93.
  268.  
  269.     Occasionally, patch tapes  are available to fix bugs and/or
  270.     add functionality betweenmajor releases.  Contact your local sales
  271.     representative for this 
  272.     information.
  273.  
  274.  
  275.     See also Section 6 (Interleaf 6).
  276.  
  277.  
  278. 1.6    What does FAQ mean?
  279.  
  280.     If you don't know what a FAQ is, you need to learn more about USENET.
  281.     Read the introductory postings in news.announce.newusers.
  282.  
  283.  
  284. 1.7    Why doesn't this FAQ contain info on <your-topic-here>?
  285.  
  286.     This FAQ is biased toward the Unix Workstation platforms, but that is
  287.     probably a function of the popularity of Interleaf on various
  288.     platforms, the popularity of competing products, and the areas of
  289.     expertise of the FAQ editors.  If you have valuable information that we
  290.     missed, or if our assumptions that you are running Unix confuse things,
  291.     we welcome your suggestions on how to improve this document.
  292.  
  293.     If something in the FAQ doesn't work for you, it may be due to the
  294.     version of the software you're running, or which platform you're
  295.     running it on.  Most of the active newsgroup contributors and FAQ
  296.     editors seem to be running very recent versions of Interleaf (i.e.,
  297.     5.3 or later) and have Unix workstation platforms, usually including
  298.     SunOS.
  299.  
  300.     This FAQ is *NOT* intended to be a substitute for the standard
  301.     Interleaf documentation.  Hopefully it will contain the most frequently
  302.     occurring issues that are hard-to-find or absent from the
  303.     documentation.
  304.  
  305.  
  306. 1.8    Should I post my question to comp.text.interleaf?
  307.  
  308.     - Understand the introductory information in the news.announce.newusers 
  309.     newsgroup.  Be sure to read the "Rules for posting to Usenet" posting.
  310.  
  311.     - Read this FAQ.
  312.  
  313.     - Post to local.test or misc.test if you've never posted before.
  314.  
  315.     If your question is still unanswered, post it.  Be sure to include all
  316.     the necessary information as appropriate such as:
  317.         The version of Ileaf you are running.  (which patches, too)
  318.         The hardware platform you are on.
  319.         The version of your Operating System and/or windowing system.
  320.         How much memory and/or swap space you have.
  321.         What type of printer it won't print on.
  322.         etc.
  323.     
  324.     This information is also important when you are asking your question
  325.     via email to someone.
  326.  
  327.  
  328. 1.9    Who wrote this awesome FAQ?  Where shall I send my donations?  :-)
  329.  
  330.     Thanks to the following FAQ contributors:
  331.     _____name_____    _____email_____                ____claim-to-fame_______
  332.     David Buchholz    buck@ileaf.com                 ILEAF Product Manager
  333.     Heidi Daitch      heidi@ileaf.com                ILEAF
  334.     Brian Diehm       briand@tekig5.PEN.TEK.COM      newsgroup contributor
  335.     Ted Fabian        tpf4434@tm0006.lerc.nasa.gov   ileaf admin
  336.     Amy Farrell       Amy.K.Farrell@tek.com          ileaf admin/user expert
  337.     Deborah Graham    djg@genrad.com                 GenRad newsletter
  338.     Adam Harrison     eros@cs.pdx.edu                FTP site maintainer
  339.     Daniel Haug       haug@austin.lockheed.com       newsgroup contributor
  340.     Stephen Keller    stephenk@zeugma.lmc.com        newsgroup contributor
  341.     Christine King    bcking@ileaf.com               ILEAF  lead VMS engineer
  342.     Steven King       king@rtsg.mot.com              newsgroup contributor
  343.     Alek Komarnitsky  alek@spatial.com               newsgroup contributor
  344.     David Lightman    dalight@afterlife.ncsc.mil     newsgroup contributor
  345.     Jon Monssarat     jgm@cs.brown.edu               general netnews wizard
  346.     Robert Morris     ram@cs.umb.edu                 LISP guru, FAQ editor
  347.     Nils-Peter Nelson npn@cbnewsl.cb.att.com         newsgroup contributor
  348.     Bret Pettichord   bret@ileaf.com                 ILEAF  QA
  349.     Bill Rea          billr@ims.com                  FAQ editor
  350.     Danny Schales     dan@engr.latech.edu            newsgroup contributor
  351.     Randy Smith       smithrh@marlin.rtsg.mot.com    ileaf admin, ng contributor
  352.     Eric Sosman       eric@ileaf.com                 ILEAF  VMS engineer
  353.     George Snyder     gjs@inmet.com                  newsgroup contributor
  354.     Chris Talbott     chris@ews7.dseg.ti.com         newsgroup contributor
  355.     Anne Tice         tice@dg-rtp.dg.com             newsgroup contributor
  356.     Todd Williams     todd@macsch.com                Unix sysadmin, FAQ editor
  357.     Brian Wong        blw@majipoor.corp.sun.com      newsgroup contributor
  358.     Dorene Woodrow    dbw@ileaf.com                  ILEAF
  359.  
  360.     You can mail to the Ileaf FAQ Editors at "leaf-faq-editors@cs.umb.edu"
  361.  
  362.  
  363.  
  364. 2.    ADMINISTRATION
  365.  
  366.  
  367. 2.1    Interleaf administration vs. Unix administration of Interleaf
  368.  
  369.     The Interleaf System Administration manual provides procedures that
  370.     require the administrator to be running Interleaf, manipulating icons,
  371.     etc., and running Interleaf programs like printer_install and
  372.     prhost_install -- is this really necessary?
  373.  
  374.     No.  But Interleaf has mixed feelings about providing "Interleaf
  375.     procedures" and "Unix procedures" for the same tasks.  Most of the
  376.     Interleaf procedures have easy Unix shortcuts, but use them at your
  377.     own risk.  The Interleaf equivalent of "ln -s" takes several mouse/
  378.     menu operations.  Some administrators edit their printers.lsp file
  379.     directly (or have their custom shell script do it), never running
  380.     the printer_install or prhost_install programs.
  381.  
  382.     In the DOS version of Interleaf 5, many of these tasks have been
  383.     simplified and moved into the hands of the end users.  For example,
  384.     prhost_install and printer_install have been merged into one program
  385.     which is run by the user from within Interleaf 5 itself.
  386.  
  387.  
  388. 2.2    Printing
  389.  
  390.  
  391. 2.2.1    Can I create PostScript files on the desktop in Interleaf 5?
  392.  
  393.     Yes.  The administrator runs printer_install and creates a new
  394.     "printer" named "PostScript" (or whatever).  Choose filtering on the
  395.     desktop, the "Other PostScript printer" model, use the NULL.PPD file,
  396.     face down output, and choose *not* to spool to the printer.  Whatever
  397.     menu name you chose (I suggest "<PostScript File>") will now appear in
  398.     the printer menu.  When selected, it will output to a PostScript file
  399.     in the current directory.  The filename will have a suffix of "_ps"
  400.     (no, Interleaf hasn't learned the ".ps" Unix convention).
  401.     [the previous paragraph works fine on the 5.3 Sun version of ileaf;
  402.     for other platforms, your mileage may vary]
  403.  
  404.     Adventuresome hackers can simply insert the following into their
  405.     /interleaf/ileaf5/data/printers.lsp file (on Unix hosts):
  406.         (
  407.         :netname "PostScript"
  408.         :menuname "<PostScript>"
  409.         :filt-args ("-ppd" "NULL.PPD" "-ft" "3")
  410.         :pdltag "ps"
  411.         :filter "pl2ps"
  412.         :install "ps_install"
  413.         :ps-type1 ("-ft" "3")
  414.         :ppdfile "NULL.PPD"
  415.         :rvopt " "
  416.         :european " "
  417.         :physical-printer "PostScript"
  418.         :spool "n"
  419.         :filter-loc "desktop"
  420.         :type "ps"
  421.         :model "Other PostScript printer"
  422.         :id :bsd-other-ps
  423.         )
  424.  
  425.     On Interleaf 5 for DOS, this comes as a default setup.
  426.  
  427.  
  428. 2.2.2    Can Interleaf 5 create Encapsulated PostScript files (EPS files)?
  429.  
  430.     Yes.  Beginning with Interleaf 5.3, you have the ability to create EPS
  431.     3.0 files as an option under the printer pulldown menu.  To add this
  432.     functionality simply add another printer using printer_install.  Select
  433.     "EPS File" as the printer type.  This will add EPS to your PRINT menu.
  434.     When printing to EPS, the EPS file will contain one entire page
  435.     (including page #, etc.).
  436.  
  437.     In Interleaf 5 for DOS, add the "-EPS" option to the switch settings
  438.     for creating PS files in the Printer Setup Tool, and save this as a
  439.     new menu entry ("Create EPS File").
  440.  
  441.     If you want to filter an object that will be placed on a page in some
  442.     other program, you'll need to set the document size appropriately.
  443.     (Unless there is some other way to let Interleaf know where the
  444.     boundaries of the object are.)  Since a typical EPS file is one graphic
  445.     object, you can set the frame size to "Contents," then back to "Fixed"
  446.     to see the actual size of the graphic.  Then, open the Page property
  447.     sheet and enter the frame height and width values as the page size.
  448.     (If someone knows a better way, we'd like to hear about it.)
  449.  
  450.     There are some subtle differences between PostScript files and EPS
  451.     files.  Each format has its appropriate uses, so both are discussed
  452.     here.  See the comp.lang.postscript FAQ for the gory details.
  453.  
  454.     One idiosyncrasy of Interleaf-generated EPS files is the line
  455.         %%BoundingBox: (atend)
  456.     Some programs insist on having the BoundingBox at the beginning of
  457.     the document, so if you have an application which chokes on ileaf
  458.     EPS, move this line to the initial comments section.
  459.  
  460.  
  461. 2.2.3    Are there special problems with SPARCprinters using NeWSprint?
  462.  
  463.     Maybe.  Some users have noted problems with SPARCprinters, and other
  464.     note problems with certain fonts or frames or bullets looking "dirty".
  465.     Make sure you have the right PPD file.
  466.     [This section is still under construction.  If you have info to add,
  467.     please send a summary to the editors]
  468.  
  469.  
  470. 2.2.4    Printerleaf-to-PostScript
  471.  
  472.     The pl2ps command can be very useful in debugging printing problems.
  473.     Create a printerleaf (*.pl) output file by selecting "Printerleaf" in
  474.     the Printers menu.  Now you can convert this to a PostScript file by
  475.     running pl2ps.  Execute "pl2ps -usage" for a summary of options.  A
  476.     typical invocation would be:
  477.         % pl2ps  -v  -ppd NULL.PPD  -i docname.pl  -o docname.ps
  478.     The -v (verbose) flag is useful for debugging.  You must always specify
  479.     a PPD file -- this is a good way to test PPD files.
  480.  
  481.  
  482. 2.2.5    PPD (PostScript Printer Definition) Files
  483.  
  484.     Adobe PostScript Printer Description (PPD) files describe how to use
  485.     the standard and special features (hardware and software) on a
  486.     specific PostScript printer.  This would include things such as which
  487.     fonts are resident, if duplexing is supported, how many trays exist
  488.     and which paper sizes are available.  PPD files are created by the
  489.     printer manufacturer, not Interleaf.  Interleaf only includes a few of
  490.     the most popular ones on its distribution tape.
  491.  
  492.     Interleaf PPD files are located in the /interleaf/ileaf5/data/ps
  493.     directory.  These files are usually named with the printer's
  494.     designation and the version of PostScript being used (e.g.,
  495.     LWNTX470.PPD means Apple LaserWriter NTX with PostScript version 4.70).
  496.  
  497.     Since the Apple LaserWriter is the simple, standard least-common-
  498.     denominator of printers, you can probably get by using the default
  499.     APPLE422.PPD file if you are running Interleaf 5.0 through 5.3.0.
  500.     If you are using version 5.3.1 of Interleaf, you can probably get
  501.     by using the NULL.PPD file.  If these files don't work (i.e., you
  502.     still can't print), or if you want to use advanced capabilites
  503.     your printer may have, you need to get the correct PPD file for your
  504.     printer.
  505.  
  506.     How to get PPD files.  If you have a printer that isn't on the
  507.     Interleaf tape, you can obtain PPD files directly from Adobe.
  508.     Adobe has an automated mail server that can e-mail PPD files
  509.     (and a bunch of other stuff) directly to you over the
  510.     Internet.  To find out what PPD files are available send mail
  511.     to: ps-file-server@adobe.com.  In the body of the message, on
  512.     the first line, type: "index PPDFiles".  The server will send
  513.     you a list of the PPD files it has available.  For information
  514.     on how to use the server, send another e-mail message to
  515.     ps-file-server@adobe.com.  In the body of the message, on the
  516.     first line, include one word: "help".  The server will send
  517.     you a message describing how to access information.
  518.  
  519.     All the PPD files on the Adobe server follow the version 4 PPD
  520.     specification.  This means that you must upgrade to version 5.3.1 or
  521.     higher of Interleaf to use type-4 PPD files.  Contact the printer
  522.     manufacturer if you need an older type-3 PPD file.
  523.  
  524.  
  525. 2.2.6    How do I suppress the Interleaf header page by default?
  526.  
  527.     The administrator should change the Print->Properties in the original
  528.     document, which lives in the SYSTEM CREATE cabinet; then any new
  529.     documents created will inherit those values.  This change is probably
  530.     effected most easily when the administrator has created a MASTER
  531.     SYSTEM5 CABINET icon on his desktop -- see the administration manual
  532.     for details.
  533.  
  534.  
  535. 2.2.7    Where can I get more specific information about my Brand XYZ printer?
  536.  
  537.     See the comp.periphs.printers and/or comp.lang.postscript newsgroups.
  538.  
  539.  
  540. 2.2.8    My output seemed to go to the printer, but nothing printed!
  541.  
  542.     One good way to debug PostScript printing problems is to download a
  543.     PostScript error handler program.  This is a simple PostScript program
  544.     that you "print" to your printer (but no output is generated).  You
  545.     now have an error-handler "loop" running until printer power is cycled.
  546.     If your Interleaf output generates improper PostScript code, instead of
  547.     silently exiting, you will get an error message printed on a page of
  548.     output, which may be of use to a PostScript guru, your printer vendor,
  549.     etc.  You can get an error handler from the Adobe mailserver (see
  550.     "PPD files", above).
  551.  
  552.  
  553. 3.    IMPORT-EXPORT, 3rd party tools, customizing
  554.  
  555.  
  556. 3.1    Importing information into Interleaf
  557.  
  558.  
  559. 3.1.1    Importing files
  560.  
  561.  
  562. 3.1.2    How do I get the name of the document into my file?
  563.  
  564.     To put the document name into a frame--typically a header or footer
  565.     frame--type Escape-@ into a text string.  Some distributions may use
  566.     the key binding Escape-n.  This won't work in microdocuments.  This is
  567.     parallel to putting in page numbers with Escape-#, or the date with
  568.     Ctrl-X d.
  569.  
  570.     The LISP command "(tell *document* mid:get-name)" will return a string
  571.     with the document name.  I suppose one could automate the insertion of
  572.     this string in much the same way as the autodate2 program (q.v.),
  573.     though I'd be interested to see something simpler.  This is such a
  574.     useful capability that I hope someone posts a nice solution.
  575.  
  576.  
  577. 3.1.3    How do I get the date into my file?
  578.  
  579.     If working in a book with a catalog, you can place the date in a shared
  580.     component or shared-content frame within the catalog.  Turn frame
  581.     and/or component exports on.  Then you only need to update the catalog
  582.     when the date changes.
  583.  
  584.     If not working in a book, you can tag the document with an attribute
  585.     for "date" and use Effectivity Control to control what date appears in
  586.     the document.
  587.  
  588.     In Interleaf 5, you can use the Ctrl-x d command in a component or
  589.     microdocument to insert the current system date, although it will not
  590.     update automatically each time the document is accessed.
  591.  
  592.     Lisp scripts can be written to insert a date that will change
  593.     dynamically, or to change the format of the date.
  594.  
  595.     Bob Morris has written some active document LISP code will make the
  596.     current date appear in an I5 document automatically when you
  597.     open it.  It will also give you the option of freezing the
  598.     date upon closing the document, i.e.  "deactivating" the
  599.     document at close time.  The latest version of this LISP file
  600.     is named "autodate2", and is available via anonymous ftp ftom
  601.     ftp.cs.umb.edu in the /pub/interleaf/lisp/ directory, and by
  602.     gopher or the World Wide Web as described in Section 6.
  603.  
  604.     In Interleaf6, a similar facility is provided with the software.
  605.  
  606.  
  607. 3.1.4    How can I make "form letters" where name/addresses are pulled in from
  608.     external sources?
  609.  
  610.     The January 1992 issue of "Foliage", the newsletter of the Northeast
  611.     Interleaf User's Group, had an article on how to do this with ASCII
  612.     markup.
  613.  
  614.     The general idea, which I have modified somewhat from the article, is
  615.     to define components such as <address>, <salutation>, <letter1>, and so
  616.     on in an Interleaf document.  Use "Global apply" or "Unify all" to make
  617.     sure the component masters match what you see on screen.  Save
  618.     <letter1> with contents, and turn on its "Shared contents" property.
  619.     Turn on the "Start new page = yes" property of The first component in
  620.     the letter, e.g. <date>.  Save the document as ASCII, with a name such
  621.     as letter_master.doc.
  622.  
  623.     Have your database write out a file such as:
  624.         <!class defaults, fill = blank>
  625.         <!Include definitions /home/my/desktop/letter_master.doc>
  626.  
  627.         <date>December 2, 1992
  628.         <address>John Smith
  629.         <address>1111 Home Street
  630.         <address>Anytown, USA 02000
  631.         <salutation>Dear Mr. Smith:
  632.         <letter1>
  633.  
  634.         <date>December 2, 1992
  635.         <address>John Q. Public
  636.         <address>222 Any Place
  637.         ...
  638.  
  639.     The <!class ...> is needed only if your external data contains multiple
  640.     lines of text within a component.
  641.  
  642.     Since line breaks are not significant, and a blank line repeats the
  643.     preceding component, the following is equivalent:
  644.         <!class defaults, fill = blank>
  645.         <!Include definitions /home/my/desktop/letter_master.doc>
  646.  
  647.         <date>
  648.         December 2, 1992
  649.  
  650.         <address>
  651.         John Smith
  652.  
  653.         1111 Home Street
  654.  
  655.         Anytown, USA 02000
  656.  
  657.         <salutation>
  658.         Dear Mr. Smith:
  659.  
  660.         <letter1>
  661.         ...
  662.  
  663.     If you load this file into Interleaf, or print it using Interleaf
  664.     command line parameters, Interleaf will expand the shared <letter1>
  665.     content in each instance.
  666.  
  667.     Substituting external data into the text of the letter is much harder.
  668.     It requires tricks with inline components, which are extremely ugly in
  669.     ASCII markup.  See the Interleaf File Formats manual for more details.
  670.  
  671.  
  672. 3.1.5    Importing Graphics
  673.         -PostScript
  674.         The psfilt program is used to import PostScript into an ileaf
  675.         document.  As of ileaf5.3, it is bundled with ileaf free of
  676.         charge.
  677.         -other Interleaf 5.3 filters will import CGM and TIFF files
  678.  
  679.     
  680.  
  681.  
  682. 3.1.6    FrameMaker---to--->Interleaf
  683.  
  684.     Interleaf has a Frame to Interleaf filter called "miffilt" which, at
  685.     last report, was in beta test.  It is planned for release in Summer
  686.     1993 for SunSPARC, HP, IBM RS-6000, Ultrix, and DOS.  It will work
  687.     with Interleaf 5.3 and will be included in the Interleaf Motif release.
  688.     The filter will be available at no charge - FREE!!!
  689.  
  690.     See also the "Interleaf-to-Framemaker" section below about Filtrix
  691.     by Blueberry Software.
  692.  
  693.  
  694. 3.2    Exporting information from Interleaf
  695.  
  696.  
  697. 3.2.1    Exporting Interleaf documents to PostScript format
  698.  
  699.     You can create PostScript or, beginning with v5.3, Encapsulated
  700.     PostScript (EPS 3.0) documents as long as your administrator has
  701.     installed the printers appropriately.  See the administration section
  702.     for information on this, plus other filtering caveats.
  703.  
  704.  
  705. 3.2.2    Exporting Interleaf PostScript into troff
  706.  
  707.     The following problem has been noted:
  708.     Interleaf, like many other proprietary packages, assumes that its
  709.     PostScript output is part of a larger (Interleaf- generated) PostScript
  710.     file.  Each fragment makes assumptions about the environment, e.g.,
  711.     counting on certain macros or variables to be defined, perhaps through
  712.     a prologue.  The troff PostScript postprocessor would have to know
  713.     about every such environment for every proprietary package a priori,
  714.     and put it in the prologue for you.  Every now and then something
  715.     works, often enough to lead you to believe it will always work.  If
  716.     you're a programmer, it's a bit like taking a C function that requires
  717.     global variables and never initializing them.  PostScript is, indeed, a
  718.     programming language, not just a printer format.
  719.  
  720.  
  721. 3.2.3    Exporting Graphics
  722.  
  723.     Many users are confused on how to export graphics.  Some users report
  724.     success when saving the Interleaf document as a PostScript file, then
  725.     using other packages to convert the PostScript to whatever format is
  726.     desired.
  727.  
  728.     Once you've got PostScript, use the GNU package GhostScript to convert
  729.     it to PBM (Portable Bit Map), GIF (Graphics Interchange Format), or PCX
  730.     (PC Paintbrush).  GhostScript is available at all the popular GNU ftp
  731.     sites.  These file formats are all compile-time options, so if you've
  732.     already got GhostScript at your site make sure it has the right formats
  733.     compiled in.
  734.  
  735.     If you need a format other than one listed above, convert to PBM first
  736.     then use the PBMPLUS suite of conversion filters to convert PBM to
  737.     whatever you need.  PBMPLUS handles a ton of file formats, and is
  738.     available at many popular ftp sites.
  739.  
  740.     If you're not on a Unix system, GhostScript is available for MS-DOS and
  741.     VMS, and PBMPLUS is available on the Amiga (and possibly other
  742.     platforms).  You can also find other graphics conversion programs for
  743.     most platforms.  PBM and GIF formats in particular are rather common,
  744.     so if you can convert to one of those it's likely you can find
  745.     something to convert to the format you really want.
  746.  
  747.     Beware of converting multiple page documents to a graphics format.
  748.     Most graphics formats don't really have the concept of "page".
  749.     GhostScript will still do the conversion, but will convert each page as
  750.     a separate image.  That's good.  Unfortunately, it puts all those
  751.     images in the same file.  That's bad.  It's pretty easy to write a sed,
  752.     awk, or perl script to split multiple PBM images out of a single file;
  753.     I've never really tried it for the other graphics formats.
  754.  
  755.     You can go through these steps to produce an image file suitable
  756.     for faxing via faxmodem!  Tell GhostScript to use a resolution of
  757.     210x98 dpi; this is the resolution of a fax machine.  (Use 210x196
  758.     dpi for "fine" mode.)  PBMPLUS includes a filter for PBM to Group 3
  759.     FAX.
  760.  
  761.  
  762. 3.2.4    Interleaf---to--->FrameMaker
  763.  
  764.     A third-party tool called Filtrix by Blueberry Software claims to
  765.     support Interleaf-to-Frame and vice versa, but at last report, the
  766.     Interleaf TPS 4.0 file format was the latest supported.  Blueberry's
  767.     number is 1-707-829-5443.  It is unknown whether a version that
  768.     supports ileaf5.3 is planned.  It is still possible to use the product
  769.     by filtering Frame to TPS4.0 and then converting to Ileaf5.  And to
  770.     go the other way, you can convert your Ileaf5 document to TPS4 before
  771.     you filter it to FrameMaker.
  772.  
  773.     Frame Technology Corp. now has an Interleaf to FrameMaker filter,
  774.     called "ileaf2mif".  For a while, Frame was offering it free to new
  775.     with new purchases, and advertising it as "the Ultimate Interleaf
  776.     Upgrade".  Some users report reasonable operation, but others note
  777.     that it will not handle equations, etc.  Like Filtrix, it only handles
  778.     the TPS4.0 version of Interleaf.  Users report:
  779.     "I've used the Interleaf->Frame filter ileaf2mif on Suns to translate
  780.     Interleaf files to MIF for end use on PC.  The filter does a
  781.     reasonable job of handling Interleaf 4.X ASCII format files, but fails
  782.     on Interleaf 5.3 ASCII format files.  You can convert within 5.3 to a
  783.     4.X format ASCII, but there are still things in the resultant file the
  784.     Frame filter doesn't like.  The only way I could make this transfer
  785.     work was convert our 5.3 files to 4.X; invoke Interleaf 4 and save the
  786.     converted files once again from Interleaf 4; then run the filter on
  787.     the 4.X files.  This worked fine.  The large caveat here is that
  788.     Interleaf 5.3 supports many features not available in 4.X.  If you
  789.     depend on any of these new features, you might be out of luck.  We
  790.     have only a few documents in this unfortunate situation; they will
  791.     continue on as Interleaf docs for the time being.  Another potential
  792.     problem is you must have Interleaf 4.  I never did isolate what the
  793.     differences were between 4.X ASCII and 5.3-converted-to-4.X ASCII.  It
  794.     might be possible to hand edit (or sed edit) the files."
  795.     "The final hurdle in filtering is that Interleaf and Framemaker
  796.     philosophies for handling shared content, graphics objects, page
  797.     layouts, you name it, differ enough that the MIF files produced by
  798.     Frame's ileaf2mif filter are at best poorly structured Frame files.
  799.     To be fair, they do make reasonable compromises and the job of
  800.     improving translated files is far easier than the job of hand
  801.     translating Interleaf documents to Framemaker."
  802.     "[Frame's Interleaf-to-Frame filter] is OK, but no raves.  It ...can't
  803.     handle all the autoreferencing since the two codes use such different
  804.     models.  I converted a 900 page manual with lots of references and
  805.     figures.  It took me about a month to get things back to an
  806.     auto-updating state in Framemaker.  Oh well, at least it beats
  807.     retyping."
  808.  
  809.  
  810. 3.3    Third Party Tools
  811.  
  812.     Contact Interleaf at 1-617-290-0710, x2381 for a list of current
  813.     Interleaf business partners, and a brief description of products which
  814.     work with Interleaf.
  815.  
  816.  
  817. 3.3.1    Spelling/Grammar Checkers
  818.  
  819.     Chris Talbott reports:
  820.     My group has had Avalanche's ProofPositive in-house for about a year
  821.     now, and it seems to be a fairly nice grammar/style checker.  It's
  822.     based on the Houghton-Mifflin engine, and it's pretty quick.
  823.     ProofPositive is an Interleaf layered application which runs against an
  824.     open document on your desktop.  It's got a fair level of control over
  825.     which rules it uses and how sensitive it is (e.g. how badly an
  826.     infinitive has to be split before it complains), and it has a
  827.     Dictionary/ Thesaurus program as well.  Our only complaint with it is
  828.     that it won't work non-interactively (a key concern for us, maybe not
  829.     for you).  Apparently, a future release of PP will allow you to define
  830.     your own grammar rules.
  831.  
  832.     Oracle produces a grammar checker for Interleaf called CoAuthor.  It
  833.     seems like it offers roughly the same capability that ProofPositive
  834.     does, for about the same price.  It uses its own UI, however, instead
  835.     of the native Interleaf one.
  836.  
  837.  
  838. 3.3.2    SQL
  839.  
  840.     Chris Talbott reports:
  841.     A third-party tool called Smartleaf allows SQL calls to be embedded
  842.     into Interleaf components, to pull information from databases into a
  843.     formatted Interleaf documents, for example.  Smartleaf is produced by
  844.     Database Publishing Software in Woburn, MA.  (617-938-0018)  They also
  845.     produce a document comparison tool called Smartleaf/Compare.  We've had
  846.     Smartleaf/Compare in-house for about as long as we have had
  847.     ProofPositive.  The tool is useful for such things as comparing an
  848.     archived version of a document/book with the "current" version
  849.     (especially if several revisions have come between the documents in
  850.     question).  As of Apr 1993, the comparison algorithm is not as robust
  851.     as might be desired, and the options for marking the changes in the
  852.     "difference document" are less than stellar, but their 3.0 release (in
  853.     alpha test Apr 1993?) is supposed to have greatly improved the
  854.     algorithm and the marking options.  Database Publishing is also
  855.     involved in developing applications for CALS/SGML support.
  856.  
  857.  
  858. 3.3.3    Clip Art
  859.  
  860.     For the GenRad newsletter, Deborah Graham uses a demo package from:
  861.     Fusion Graphics, 1728 Moorpark Road, Thousand Oaks, CA 91360,
  862.     1-805-494-8411.  They have an extensive collection of clip art that
  863.     is compatible with Interleaf and other systems.
  864.  
  865.     See also the discussions about the Leafline bulletin board.
  866.  
  867.  
  868. 3.3.4    Graphics tools
  869.  
  870.     XV is a shareware program by John Bradley of U. Penn.  It can read
  871.     and write GIF, PM, PBM, X11 bitmap, Sun Raster, PostScript, JPEG,
  872.     and TIFF file formats, and is a very useful translation tool.  It is
  873.     available via ftp from ftp.cis.upenn.edu in the /pub/xv directory.
  874.  
  875.     IslandPaint, from Island Graphics, is a good bitmap (or raster)
  876.     graphic editor.  It can read TIFF, GIF, Group3 FAX, Sun Raster, and
  877.     X11 bitmap files.  It can write TIFF and Sun Raster files that
  878.     Interleaf can filter into pasteable graphic images.
  879.  
  880.     IslandDraw, from Island Graphics, is a good object drawing editor.
  881.     It can read and edit EPS, EPS objects, CGM, HPGL, PICT, and Frame
  882.     3.0 MIF drawings.  It writes EPSF, EPSI, TIFF, CGM, and Frame 3.0 MIF
  883.     file formats.  Interleaf can directly paste in EPSI drawings (and
  884.     display them on screen as of v5.3.1)
  885.  
  886.     CorelDraw, from Prior Data Sciences, is a drawing program that
  887.     imports and exports "most standard graphics formats such as TIFF
  888.     and EPS".
  889.  
  890.  
  891. 3.4    Customizing tips
  892.  
  893.  
  894. 3.4.1    Startup options
  895.  
  896.     Many startup options for Interleaf are configurable via X11 resources.
  897.     See chapter 1 of the Interleaf 5 System Administation manual.  Startup
  898.     options start on page 1-8.  Xresources are on pages 1-14 through 1-16.
  899.     One favorite addition to $HOME/.Xdefaults files is
  900.         Ileaf.geometry:    1141x869+0+0
  901.     which works well on Suns to make the desktop window cover the whole
  902.     screen.  Many startup options can also be handled with command line
  903.     options.
  904.  
  905.  
  906. 3.4.2    Mouse Buttons
  907.  
  908.     How can you change the default mouse buttons on a site-wide basis?
  909.  
  910.     Edit /interleaf/ileaf5/english.cab/Custom.cab/profile.drw/init.lsp
  911.     (english.cab may be a different name, depending on the installed
  912.     language).  Each Interleaf user has a symbolic link to this file from
  913.     their ~/desktop/System5.cab/Custom.cab/profile.drw.  Uncomment the
  914.     three lisp commands shown below, and edit them to specify the desired
  915.     system default actions.
  916.         ;;;
  917.         ;;;     Mouse button mappings:
  918.         ;;;
  919.         ;(tell *wn-wmgr* mid:set-props :left-button :select)
  920.         ;(tell *wn-wmgr* mid:set-props :middle-button :menu)
  921.         ;(tell *wn-wmgr* mid:set-props :right-button :extend)
  922.     Any user with a customized profile (e.g. created with Profile Tool)
  923.     will get the settings from the profile, overriding these defaults.
  924.  
  925.  
  926. 3.4.3    Keyboard mapping
  927.  
  928.     Many users have asked about changing the function/behavior of
  929.     certain keys.  Some complain of "no R1 key on the Sun keyboard",
  930.     or want "a delete-to-the-right key like TPS4.0 had".
  931.  
  932.     One solution is to use xmodmap(1).  This, however, is not a "within
  933.     Interleaf" solution -- xmodmap will change the keyboard mappings for
  934.     the whole login session.
  935.  
  936.     One small example of xmodmap is the following command, which will
  937.     make the "Del" key on the right hand keypad of a Sun (keycode 57)
  938.     perform the function of the "Cut/L10" key ("F20"):
  939.         xmodmap -e keycode 57 + F20
  940.     
  941.  
  942. 3.4.4    Default document templates
  943.  
  944.     The documents in your ~/desktop/System5.cab/Create.cab are those which
  945.     you see when you press the menu button with nothing selected on the
  946.     desktop, and then pull right a submenu on "Create".  Note that some
  947.     files in this directory are typically links into the master cabinet.
  948.     You can remove these links and create your own, or use the more popular
  949.     method of creating your own subdirectory (called "mytemplates.fdr" for
  950.     example).  Put your template documents there, and then pull right thru
  951.     Create->mytemplates-> to create new documents.
  952.  
  953.     For site-wide templates, the administrator can place templates in
  954.     the Master System5/Create.cab/Templates.fdr.  Each user will have to
  955.     execute Custom-->Misc-->Update in their Templates.fdr to get these
  956.     new templates.
  957.  
  958.  
  959. 3.4.5    Changing the color of the desktop
  960.  
  961.     With the User Interface Painter, you can make your desktop and icons
  962.     any color you want.  You first need to turn on the UI Painter in the
  963.     Custom->ToolMgr.  Then you can select a default color scheme from
  964.     Create->Tools->UIPainter, and modify it if you wish with the color
  965.     editor.  To make the change permanent, copy the UI Painter icon you
  966.     created into your System5--Custom--profile drawer.
  967.  
  968.     Some users report that use of the UI Painter causes more frequent
  969.     occurrences of SIGSEGV and SIGBUS signals.  Revision Tracking has also
  970.     been blamed for this.
  971.  
  972.  
  973. 3.4.6    Creating color documents
  974.  
  975.     By default, when you try to Edit->Color, you just get shades of gray.
  976.     You must create any colors you want to use by first going into the
  977.     Palette->Color Editor (document name menu Misc-> pull right menu).
  978.     See your hardcopy Interleaf documentation for details.  These colors
  979.     can be made site-wide by modifing the Master document in the Master
  980.     System5 cabinet.
  981.  
  982.  
  983. 3.4.7    Creating User defined patterns
  984.   
  985.     By default, interleaf gives you 16 patterns.  To add to these, use the
  986.     Pallette->Pattern editor.  Again, site-wide patterns should be added
  987.     to the Master document in the Master System5 cabinet.
  988.  
  989.  
  990.  
  991. 4.    MISC USER QUESTIONS
  992.  
  993.  
  994. 4.1    How can I print "DRAFT" diagonally across the background of each page?
  995.  
  996.     Create a frame in a component and designate the placement as "underlay"
  997.     through the frame props.  Enter text string "DRAFT" using ctrl-O,
  998.     convert the text to outline, size it, edit it to a light shade of gray,
  999.     then rotate it.  Make the frame shared content, and set props to
  1000.     Repeat=Begin, Anchors_Page=Yes so that it will show up on every page of
  1001.     the document.
  1002.  
  1003.  
  1004. 4.2    Is there any way to rotate microdocuments?
  1005.  
  1006.     No.  If you need to rotate text, use ctrl-O text strings (hit ctrl-O
  1007.     inside a frame, then enter text).  You can only rotate ctrl-O text
  1008.     strings in 90-degree increments.  To get anything else, convert to
  1009.     outline.
  1010.  
  1011.  
  1012. 4.3    How can I search and replace with a tab or hard return? 
  1013.  
  1014.     In order to search for, or replace with, a tab or a hard return,
  1015.     preface the tab or return key with the <esc> key.  (This is the ALT key
  1016.     for the IBM RT, and F11 on DEC/Ultrix and VAX/VMS.)
  1017.  
  1018.  
  1019. 4.4    Can I get international characters on my U.S. based version of
  1020.     Interleaf 5?
  1021.  
  1022.     Yes, with your cursor in the text area, choose Create->Char, then
  1023.     choose the desired font.  Extend the menu and you will see the
  1024.     international characters.  You can also get these through keys as
  1025.     described in the online document Compose_Sequences under
  1026.     System5->Release Notes.
  1027.  
  1028.  
  1029. 4.5    Will fast startup under Interleaf 5.3 help with performance?
  1030.  
  1031.     The fast startup options available under Interleaf 5 (5.3) reduce the
  1032.     amount of time it takes to bring up a desktop.  However, once the
  1033.     desktop is up, no other performance gains are realized.  Interleaf
  1034.     documentation explains the optional fast startup commands available.
  1035.  
  1036.     Note two things: (a). fast startup creates a file on your
  1037.     desktop about 5mB in size. (b). A substantial amount of system
  1038.     state is saved in the fast startup file (that's how it works).
  1039.     This often means that under some circumstances you may need to
  1040.     remove the file ileaf.fst from your desktop so that it is
  1041.     recreated. This is advisable after any new releases of the
  1042.     software, of site-wide or individuallly installed
  1043.     applications, or in some cases if carelessly written active 
  1044.     documents make assumptions about the system state.
  1045.  
  1046.  
  1047.  
  1048. 4.6    How can I capture popups in Interleaf 5.3 under OpenWindows?
  1049.  
  1050.     At the Unix prompt, type
  1051.          % sleep 10; capture
  1052.     You'll then have 10 seconds to setup the popup to be captured. The
  1053.     capture box will appear and mouse control will be transferred to it.
  1054.     The middle button will give choices of Move, Capture, Size and Quit.
  1055.     Capture will create an image.img file, placed in your home directory,
  1056.     that can be pasted into a document.
  1057.  
  1058.  
  1059. 4.7    Keyboard types
  1060.  
  1061.     If Interleaf won't start with error messages like:
  1062.         In system startup file:
  1063.         Error: Wrong argument type: nil
  1064.         (logand 32767 (x-keycode-to-keysym 12 0))
  1065.  
  1066.     then you need to specify your keyboard type with the -keyboard switch:
  1067.         ileaf -keyboard keyboard_type
  1068.  
  1069.     "none" is a valid keyboard type, but you won't have any key mappings,
  1070.     like page-up/page-down.  The choices in 5.3 are:  apollo, aviion, dec,
  1071.     hp, rs6000, sun_type3, sun_type4, none.  (The command switches are in
  1072.     the System Administration manual.)
  1073.  
  1074.     If you have a Sun Type 5 keyboard, you need the "patch tape" which
  1075.     brings Interleaf 5.3 to 5.3.1.
  1076.  
  1077.  
  1078. 4.8    Does Interleaf read this newsgroup?
  1079.  
  1080.     "Lots of us at Interleaf, from all walks, read the messages.  And we're
  1081.     very glad this newsgroup is up and running.  But we also recognize that
  1082.     this is a medium for our users, not for Interleaf, Inc.  So, we are
  1083.     encouraging Interleafers not to jump into discussions prematurely.  Our
  1084.     unofficial policy is that if a Leafer has an answer to a question which
  1085.     other users don't appear to be responding to (or if it's a request for
  1086.     information that really should be addressed by us), then we'll reply
  1087.     privately.  There may, of course, be occasions where a public reply
  1088.     makes most sense, so we won't rule that out."
  1089.  
  1090.  
  1091. 4.9    Why does my tutorial crash?
  1092.  
  1093.     Many problems were noticed with the tutorial in v5.2.  Many of these
  1094.     were fixed in v5.3.  Paranoid users who wish to run the tutorial might
  1095.     want to temporarily rename their desktop directory before running the
  1096.     tutorial, and then rename it back when finished.
  1097.  
  1098.  
  1099. 4.10    Why doesn't Interleaf have an indent command or keystroke?
  1100.  
  1101.     It's not appropriate for Interleaf to have a simple indent command.
  1102.     Property Sheets are germane to the point of structured document
  1103.     editors.  If you "merely" indent without changing the document objects,
  1104.     you are essentially imputing structure from format.  This is a Bad
  1105.     Thing as it makes it very difficult to edit structure later on.  On the
  1106.     other hand, format deduced from structure, as provided by many systems
  1107.     with "style sheet"-like mechanisms, is easy to edit.  Also, it does not
  1108.     lead to confusion when the format is to be changed.  For a most
  1109.     dramatic example, see "Can Structured Formatters Prevent Train
  1110.     Crashes?", J.  Andre, Electronic Publishing---Origination,
  1111.     Dissemination and Design (EP-ODD), v. 2 #3, pp169-174, October 1989).
  1112.  
  1113.     However, it is possible in Interleaf 5 to provide keyboard actions
  1114.     which will edit structure as well as content.  Bob Morris has written
  1115.     some Lisp which will do this for the indentation toggling problem.
  1116.     Contact him for more info.
  1117.  
  1118.  
  1119. 4.11    Memory leaks
  1120.  
  1121.     Interleaf has been known to allocate large amounts of virtual memory
  1122.     and never give it back.  If you get an "out of memory" message, try
  1123.     exiting Interleaf and trying the operation again.  Users who remain
  1124.     logged in for days/weeks/months with Interleaf running the whole time
  1125.     exacerbate this problem.  You can use the Unix "pstat -T" command to
  1126.     view the amount of virtual memory being used.
  1127.  
  1128.     Under HP-UX, use "/etc/swapinfo -t" instead of pstat.  HP-UX has some
  1129.     memory leak problems in the vfork() call that can be fixed with kernel
  1130.     patch PHKL_0743 for HP-UX 8.07.
  1131.  
  1132.     Patch PRA # 93-15 for Interleaf 5.3.1 is available to address memory
  1133.     leak problems.  Some sites have already worked around this problem
  1134.     by running on workstations with large amounts of memory and swap
  1135.     space.
  1136.  
  1137.  
  1138. 4.12    Runaway processes; exiting Interleaf
  1139.  
  1140.     If Interleaf is not exited properly, it may continue to run.  Sun
  1141.     OpenWindows users, for example, may logout via the OpenWindows menu's
  1142.     "Exit".  This will cause Interleaf to continue to run, consuming memory
  1143.     and cpu time.
  1144.  
  1145.  
  1146. 4.13    How do I get a clock permanently on my desktop?
  1147.  
  1148.     Copy the Clock.lsp lisp program to your profile drawer.  Any lisp
  1149.     programs in your profile drawer will be run every time you start
  1150.     Ileaf.
  1151.  
  1152.     For Unix types:
  1153.         % cp /interleaf/ileaf5/english.cab/Custom.cab/No_Selection.cab\
  1154.         /Misc.drw/Clock.lsp ~/desktop/System5.cab/Custom.cab/profile.drw
  1155.  
  1156.     (note that the above is one line, and that I broke the pathname
  1157.     in the middle)
  1158.  
  1159.     For Interleaf types:
  1160.         open System5->Custom->No_Selection->Misc
  1161.         copy the Clock lisp icon
  1162.         open System5->Custom->profile
  1163.         paste the Clock lisp icon at the bottom right.
  1164.  
  1165.     Lisp hackers can now edit your copy of Clock.lsp, and change the
  1166.     font/window size/window postion/etc.
  1167.  
  1168.  
  1169. 4.14    I created a file in my desktop directory but Interleaf doesn't see it!
  1170.  
  1171.     Any files created under your desktop directory by processes other than
  1172.     Interleaf (e.g. from a Unix shell prompt) while Interleaf is running
  1173.     do not appear as icons.  Conversely, files removed still have icons
  1174.     displayed.
  1175.  
  1176.     To make newly created files appear, choose Custom->Rescan.  Automatic
  1177.     rescan can be set in your profile using the profile tool, but since
  1178.     it slows things down it is disabled by default.
  1179.  
  1180.     Also use Rescan when removing files, but remember that any FileName.doc
  1181.     will have a .@FileName.doc file associated with it for icon
  1182.     positioning.  If you don't remove both files, you'll get strange
  1183.     behavior later.
  1184.  
  1185.  
  1186. 4.15    What are all these funny Unix filenames?  What's this Mona Lisa icon?
  1187.  
  1188.     If you cd to your desktop directory and do an ls -a, you may see things
  1189.     that don't seem to correspond to the icons Interleaf shows you.  These
  1190.     are documented on pages 1-6 through 1-8 of the System Administration
  1191.     manual, along with the meaning of each type of icon.
  1192.  
  1193.  
  1194. 4.16    Is there any way to count the number of words in an Interleaf document?
  1195.  
  1196.     If you have a lot of documents and want to automate this, you may well
  1197.     find it easier and faster to run Unix shell scripts which:
  1198.         1. Run Interleaf in batch mode to make the files interleaf ascii.
  1199.         2. Run textfilt to strip markup.
  1200.         3. Use the Unix wc(1) program to count words.
  1201.  
  1202.     Bob Morris has written some Lisp code which will count words.  It may
  1203.     or may not be useful to you.  Ask him for details.
  1204.  
  1205.  
  1206. 4.17    Is there a way to sum up and/or sort a row or column in a table?
  1207.  
  1208.     David Lightman reports that there is a simple Lisp script available
  1209.     from the Leafline (q.v.) which sorts a column in ascending ascii.
  1210.  
  1211.     Also he has written some Lisp scripts to sum a column (sorry haven't
  1212.     done rows), along with changing the attributes of row components based
  1213.     on a value you enter (simple database query idea).  Contact him for
  1214.     more info.
  1215.  
  1216.  
  1217. 4.18    Is there a way to view an Interleaf document without starting Ileaf?
  1218.  
  1219.     This is what Interleaf's WorldView product can do. (q.v.)
  1220.  
  1221.  
  1222. 4.19    When I try to fill a box, I get a diagonal line instead!
  1223.  
  1224.     This is a bug that occurs when you use "Zoom" (in the pulldown menu
  1225.     under the "View" bar just below the filename).  It occurs only when
  1226.     "View" is different than "x1".  Use "Zoom" for text only.  If you want
  1227.     to zoom in on a graphics object, inside the frame use the pullright
  1228.     menu option Misc->View->Magnify->Larger.
  1229.  
  1230.  
  1231. 4.20    Big blank white squares
  1232.  
  1233.     On some systems, after you dismiss a menu or other popup over the
  1234.     desktop, the space under the menu will remain as a blank white square,
  1235.     instead of refreshing.  The fix for this is to edit the .Xdefaults file
  1236.     and add:
  1237.         Ileaf.popup.saveUnder:  true
  1238.     This behavior seems common on systems running the MIT X11R5
  1239.     server. Note that the precise capitalization of the string
  1240.     Ileaf.popup.saveUnder is critical.
  1241.  
  1242.  
  1243.  
  1244. 4.21    How do I start a new page with component xyzzy?
  1245.  
  1246.     Select the component xyzzy, open its props, and click on Page props.
  1247.     Set the start new page to Yes.
  1248.  
  1249.  
  1250. 4.22    How do I line up columns?  (spaces don't work)
  1251.  
  1252.     Use tabs and set the spacing on the Tab Property sheet for the
  1253.     component.  You can also use this to align numbers on a decimal
  1254.     point.  Better yet, use tables.
  1255.  
  1256.  
  1257. 4.23    How do I combine two separate documents into one?
  1258.  
  1259.     Select the first document and open it.  Select the second document
  1260.     and cut it.  Now move to the point in the open document you want to
  1261.     place the cut document, and execute paste in the COMPONENT BAR.
  1262.  
  1263.  
  1264. 4.24    What useful lisp scripts come with interleaf?
  1265.  
  1266.     If your administrator has installed leafware from the distribution
  1267.     tape you have access to a many UNSUPPORTED lisp scripts.  One that
  1268.     may prove useful is keyboard-typo (a better name is auto-quote).
  1269.     This automatically puts in an open qoute or close quote as required;
  1270.     it also changes the - to a hyphen instead of a minus sign.  Another
  1271.     useful script is iconify, which allows you to hide your open document
  1272.     window and gives you back your desktop space so you can find another
  1273.     document.  There is also a script to mail an ascii stripfiltered
  1274.     version of your document to a person you specify.
  1275.  
  1276.  
  1277. 4.25    What is "Interleaf-J" ?
  1278.  
  1279.     That's the Japanese (kanji) version of Interleaf.  It is reported to
  1280.     have slightly greater memory/swap requirements than the English
  1281.     version.
  1282.  
  1283.  
  1284.  
  1285. 5.    Platform-Specific questions
  1286.  
  1287.  
  1288. 5.1    DEC VMS
  1289.  
  1290.     Note that most of this information can be found in the RELEASE NOTES.
  1291.  
  1292.  
  1293. 5.1.1    What are the most common issues users encounter when installing and
  1294.     configuring Interleaf 5 on DEC VMS?
  1295.  
  1296.     To install Interleaf 5, a minimum of 20K free disk blocks is required
  1297.     on the system disk.  This is used as temporary file storage in
  1298.     SYS$UPDATE during VMSINSTAL.  This is temporary file storage, not
  1299.     permanent.  Should the installation fail due to insufficient disk space
  1300.     on the system disk, some files may be left kicking around in
  1301.     SYS$UPDATE.  These should be deleted prior to rerunning VMSINSTAL.
  1302.  
  1303.     In some cases, Interleaf 5 gets installed with incorrect file
  1304.     ownerships and file protections.  The installation procedure attempts
  1305.     to set the file ownership to SYSTEM.  This will fail if the identifier
  1306.     [SYSTEM] does not exist.  This can be fixed by setting the files
  1307.     ownership to [1,4], and resetting file protections to WORLD
  1308.     READ/EXECUTE.  For example:
  1309.         $ SET FILE/OWNER=[1,4]/PROT=W:RE disk:[dir...]*.*;*
  1310.  
  1311.     If the Interleaf top level home directory is created prior running
  1312.     VMSINSTAL, WORLD protections must be set to READ/EXECUTE.
  1313.  
  1314.     If running TPS4 and Interleaf 5 concurrently, do not change the IWS
  1315.     symbol definition for Interleaf 5 as this is called for other routines
  1316.     such as PRINTER_INSTALL and LICENSE_INSTALL.
  1317.  
  1318.     Do not install FMU in the Interleaf 5 hierarchy.  This will cause
  1319.     problems with LICENSE_INSTALL and possibly other routines.
  1320.  
  1321.  
  1322. 5.1.2    What can I do to increase the performance of Interleaf 5 under VMS?
  1323.  
  1324.     Some performance gains can be acquired by properly tuning the system.
  1325.     Adjusting working sets so that the Interleaf user has access to all
  1326.     available free memory can help.  This can be done by doing the
  1327.     following:
  1328.  
  1329.     Run WSMAX.COM to find out how large the SYSGEN parameter WSMAX can be
  1330.     set.
  1331.         $ @IWS5$BIN:WSMAX
  1332.     Add the value that WSMAX.COM provided to MODPARAMS.DAT
  1333.  
  1334.         $ SET DEFAULT SYS$SYSTEM:
  1335.         $ EDIT MODPARAMS.DAT
  1336.     (add or modify the value of MIN_WSMAX to the one provided by WSMAX.COM)
  1337.  
  1338.     Modify the UAF records for the Interleaf user(s) by setting their
  1339.     WSEXTENT to be equal to the value supplied by WSMAX.COM
  1340.  
  1341.         $ RUN AUTHORIZE
  1342.         UAF> MODIFY user/WSEXT=XXXXX !where user = the Interleaf username
  1343.         and XXXXX = WSMAX
  1344.         UAF> EXIT
  1345.  
  1346.     Now run Autogen to set the SYSGEN param WSMAX and reboot
  1347.         $ @SYS$UPDATE:AUTOGEN SAVPARAMS SETPARAMS
  1348.         $ @SYS$SYSTEM:SHUTDOWN
  1349.     When the system comes back up, these changes should be in place.
  1350.  
  1351.  
  1352. 5.2    DOS
  1353.  
  1354. 5.2.1    How is the performance of Interleaf on the DOS platform?
  1355.  
  1356.     One may assume that since Interleaf is often slow on a workstation,
  1357.     it must be unbearable on a DOS machine.  "Not so!", say the DOS
  1358.     Interleaf users.  Bob Morris reports that his 33mHz 486 with 8MB
  1359.     memory and a 12ms IDE disk is faster than his SPARCstation 1.
  1360.     Note that most workstation users have to deal with multitasking
  1361.     operating systems that do not dedicate 100% of their cycles to
  1362.     running Interleaf, plus they often NFS-mount the executables and/or
  1363.     the data.  A workstation with a fast local disk would be a different
  1364.     story.
  1365.  
  1366.  
  1367. 5.2.2    How can I run stuff from the command line under DOS?
  1368.  
  1369.     With I5 DOS all of the filters and print programs are implemented as
  1370.     Dynamic Link Libraries (DLL's).  This means that the command line
  1371.     invocation requires a slight twist.  All of the same I5 programs exist
  1372.     (pl2ps for example) but have an extension of ".i5".  These files must
  1373.     be run from the command line with the loader "i5load.exe".  The way to
  1374.     run the filters is then (while cd'd to \ileaf5\bin):
  1375.  
  1376.     C:\ILEAF5\BIN> I5LOAD PL2PS.I5 -v -ppd NULL.PPD -i docname.pl -o docname.ps
  1377.  
  1378.  
  1379.  
  1380. 6.0    Interleaf 6
  1381.  
  1382.     Interleaf 6.0 offers very little absolute new functionality
  1383.     over Interleaf 5. The release is mainly intended to offer a
  1384.     system more easily used by people familiar with X-windows and
  1385.     Microsoft Windows.
  1386.  
  1387.     A brief personally edited list of some typical differences,
  1388.     written by Bob Morris, follows. For how to get more detailed
  1389.     information, see the Appendix below.
  1390.  
  1391.     a. The UI is conformant to Motif and incorporates some Windows
  1392.     features.
  1393.  
  1394.     b. Multiple property sheets can be open at one time.
  1395.  
  1396.     c. Online documentation is hypertext, based on WorldView.
  1397.  
  1398.     d. Search and Replace is improved.
  1399.  
  1400.     e. Editable text can be rotated 90 degrees.
  1401.  
  1402.     f. Initial content of componets can call Lisp functions for
  1403.     computationally determined content, e.g. the current date.
  1404.  
  1405.     g. Printer administration is simplified.
  1406.  
  1407.  
  1408. 7.0    Cyberleaf
  1409.  
  1410.     Cyberleaf is an Interleaf product for the creation and
  1411.     management of Webs in the WorldWide Web. It translates
  1412.     to HTML, the WWW format, from several popular formats,
  1413.     including WordPerfect 5.x, Microsoft Word 6.0, Interleaf,
  1414.     plain text, and (without change) HTML. The software allows
  1415.     a point-and click creation of hypertext links, translates
  1416.     links from those source documents which support them, and
  1417.     arranges for the deposit of the resulting Web in a
  1418.     specified location. Styles in the input document can be
  1419.     mapped to particular HTML styles at the choice of the user.
  1420.  
  1421.     The Unix version of Cyberleaf 1.0 was released in
  1422.     February, 1995. Requirements:
  1423.  
  1424.         Sun Sparc2/IPX (or greater)
  1425.         under Sun OS 4.1.x, or Solaris 2.x
  1426.         24mB RAM, 65mB disk, 64mB swap
  1427.  
  1428.         HP 700/8xx
  1429.         under HP-UX v9.x
  1430.         32mB RAM, 65mB Disk, 64mB Swap
  1431.  
  1432.         IBM RS/6000
  1433.         under AIX 3.2.x
  1434.         32mB RAM, 64mB Disk, 64mB Swap
  1435.  
  1436.         Dec AXP 
  1437.         under OSF/1
  1438.         48mB RAM, 64mB Disk, 64mB Swap
  1439.     
  1440.     Cyberleaf and other Interleaf product information is available
  1441.     on the Web at http://www.ileaf.com
  1442.  
  1443. Appendix: Other sources of information
  1444.  
  1445.  
  1446.  
  1447. A.1.1    Bob Morris also has an ANONYMOUS FTP site at UMASS-Boston.  
  1448.     On ftp.cs.umb.edu, see the /pub/interleaf directory.  Many
  1449.     LISP scripts such as "autodate"
  1450.     (discussed later) are in the /pub/interleaf/lisp directory.
  1451.     Contributions of interesting LISP scripts are welcome.  This newsgroup
  1452.     is archived in /pub/news, and comp.text.sgml and maybe some other stuff
  1453.     may be archived soon. comp.text.interleaf is also available
  1454.     from cs.umb.edu's GOPHER server. WAIS and mail-server access
  1455.     are contemplated. An additional FAQ for I5 written by Julie
  1456.     Barker when she was at ComputerVision is also archived there
  1457.     (BarkerFAQ).
  1458.  
  1459.     These archvives can be accessed via gopher against
  1460.     ftp.cs.umb.edu or in the WorldWide Web at
  1461.     http://ftp.cs.umb.edu, in both cases under the interleaf
  1462.     entry.
  1463.  
  1464. A.1.2    Adam Harrison maintains an ANONYMOUS FTP site for Interleaf items.
  1465.     On potemkin.cs.pdx.edu (131.252.20.145), see the pub/ileaf directory.
  1466.     Many local Interleaf user groups and other companies/organizations
  1467.     publish their own NEWSLETTERS.  One very popular one is published
  1468.     by Deborah Graham of GenRad, Inc.  For more info, contact her at
  1469.     djg@genrad.com.  You can receive her newsletter via email at no
  1470.     charge.
  1471.  
  1472. A.2    Some Interleaf marketing documents on I6 and how to get them
  1473.     and related documents can be obtained in the ways described in
  1474.     the following documents, which have identical content,
  1475.     accessible via different methods.
  1476.  
  1477.     via ftp: ftp.cs.umb.edu /pub/interleaf/marketing/00Index
  1478.     via gopher: ftp.cs.umb.edu interleaf/marketing/00Index
  1479.     via www: http://ftp.cs.umb.edu/0/interleaf/marketing/00Index
  1480.  
  1481.  
  1482.  
  1483. *** END OF INTERLEAF FAQ ***
  1484. ================================================================================
  1485. Bob Morris    Dept. of Math and CS, UMASS-Boston, Boston, MA 02125-3393
  1486. ram@cs.umb.edu    telephone 617-287-6466
  1487.